home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / Timing / PMClock150.lha / PMClock / PMClock.doc < prev    next >
Encoding:
Text File  |  1993-09-17  |  8.5 KB  |  270 lines
  1.  
  2.         a
  3.          ___   __    __              ____ _____
  4.         |   \ |  \  /  |    /\  /\  |       |
  5.         |    )|   \/   |   (   /  \ |___    |
  6.         |  _/ | |\  /| | -  \ (    )|       |
  7.         | |   | | \/ | |     ) \  / |       |
  8.         |_|   |_|    |_|   \/   \/  |       |
  9.  
  10.         P R O D U C T I O N
  11.  
  12.  
  13.         *** PMClock V1.50 *** Guide by David von Plenker-Tind ***
  14.         
  15.  
  16.  
  17.  
  18. ##
  19. ## Information About PM-Soft
  20. ##
  21.  
  22. PM-Soft consists of Niklas Dahlman and
  23.                     David von Plenker-Tind.
  24.  
  25. We started with our first project in 1991. It was, and still is, a Train
  26. Interface Driver, also known as TID©. TID© is still under development and
  27. it expands all the time. Our second project is this one, the PMClock©,
  28. but more about it later. More projects are on thier way.
  29.  
  30. Our bigger programs are ShareWare (we take a small fee for the
  31. usage of the program) like TID©, but our smaller programs are
  32. desperado-ware. We would like you to send us something (could be
  33. anything except letter-bombs). If you send something that we like
  34. we just might send you a free upgrade of the program (don't forget
  35. to specify wich program you award with your gift or thing).
  36.  
  37.  
  38.  
  39. ##
  40. ## DISCLAIMER
  41. ##
  42.  
  43. ************************************************************************
  44. *                                                                      *
  45. *                            DISCLAIMER                                *
  46. *                                                                      *
  47. *   THIS SOFTWARE IS PROVIDED "AS IS".                                 *
  48. *   NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE      *
  49. *   ACCURACY, RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION      *
  50. *   OF THIS SOFTWARE, AND ALL USE IS AT YOUR OWN RISK.                 *
  51. *   NEITHER COMMODORE NOR THE AUTHORS ASSUME ANY RESPONSIBILITY OR     *
  52. *   LIABILITY WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE.    *
  53. *                                                                      *
  54. ************************************************************************
  55.  
  56.  
  57.  
  58. ##
  59. ## Info about PMClock
  60. ##
  61.  
  62. PMClock is a small clock! It show the time like a digital clock, with
  63. hours, minutes and seconds in digits in a small title-bar-like window.
  64.  
  65.  
  66.  
  67. ##
  68. ## Why?
  69. ##
  70.  
  71. Niklas who made this little smart utility, thought
  72. he missed something when he worked with his computer. So, he sat down
  73. and wrote this clock. It's a very small and nice little clock and it can
  74. be placed in any public screen The interface is
  75. easy to understand and use, but it provides a rather large range of
  76. control possibilities
  77.  
  78.  
  79.  
  80. ##
  81. ## System Requirements
  82. ##
  83.  
  84. PM-Soft's software are programmed ON 2.x+ mashines FOR 2.x+ mashines.
  85. This mean that all our software will require OS2.04 or higher (kickstart
  86. 37.175) The programs are tested on OS2.04 and OS3.0 mashines.
  87.  
  88. N.B.  If YOU are a OS2.x+ user WITHOUT a battery-backed clock, we would
  89. like to know if PMClock works. We haven't tested this config (we can't
  90. afford to keep low-end systems strictly for testing).
  91.  
  92. PMClock is using the commodities.library in order to read the ToolTypes
  93. from the icon. If this disk-based library is missing, PMClock will start
  94. with all ToolType-values as default.
  95.  
  96.  
  97.  
  98. ##
  99. ## How you use PMClock
  100. ##
  101.  
  102. PMClock can be started both from WB and Shell. To start it from WB, you
  103. double-click on the PMClock-icon and PMClock will pop up on your
  104. WB-Screen. In order to control the place were you want PMClock to pop up
  105. you can specify several ToolTypes in the icon (see chapter ToolTypes).
  106. To start PMClock automaticly when you start your WorkBench, you can copy
  107. PMClock to the WBStartup-drawer on your SYS:-disk. Don't forget to set
  108. the DONOTWAIT-ToolType in the icon.
  109.  
  110. To start PMClock from Shell you just type 
  111.  
  112. PMClock
  113.  
  114. in a Shell-window.
  115. ToolTypes can also be specified from Shell (Read more about ToolTypes).
  116.  
  117. PMClock PUBLICSCREEN=TERM
  118.  
  119. This command-line will start PMClock on the Term-PublicScreen if it does
  120. exist. If it don't, PMClock will open on the WB-Screen. PMClock is
  121. auto-detaching so you can close the Shell-window after starting PMClock.
  122.  
  123.  
  124.  
  125. ##
  126. ## The Different ToolTypes
  127. ##
  128.  
  129. PMClock supports several ToolTypes. This is a easy way to configure the
  130. clock so it can suit any user.
  131.  
  132. The following ToolTypes are supported:
  133.  
  134. LEFT     Places the clock on the specified pixel in x-led. Default is
  135.          next to the depth-gadget on the screen. Even Overscan and
  136.          Bigger-than-average-screen is supported.
  137.  
  138. TOP      Places the clock on the specified pixel in y-led. Default is 0.
  139.  
  140. DELAY    Delays the opening of the window if you for some reason would
  141.          like to do that(?!). If not specified 0. The DELAY-time is given
  142.          in ticks (there are 50 ticks per second).
  143.  
  144. PUBLICSCREEN    You can specify a PublicScreen that PMClock will open its
  145.          window on. In the Icon TERM is specified as an exampel. If the
  146.          PublicScreen that is specified does not exist PMClock will open
  147.          on the default PublicScreen. This ToolType is case-sensitive. You
  148.          can start one PMClock on the WorkBench-screen, start Dopus and
  149.          then start PMClock again and it will open on the Term-screen. 
  150.  
  151. SECONDS  ON or OFF. To be or not to be is the question of this ToolType.
  152.          If it's set to OFF the seconds will be turned off and the window
  153.          can be amde much smaller (it's of course depending on the font-size).
  154.          The default-value is ON (the seconds turned on). Like the
  155.          PUBLICSCREEN-ToolType, this is also case-sensetive.
  156.  
  157. WIDTH    This ToolType will set the width of the PMClock-window. This
  158.          ToolType is used if the font that is used is wider than the
  159.          default 120 pixels. It can also be used for making the window
  160.          smaller together with the SECONDS=OFF-ToolType.
  161.  
  162. The ToolTypes in the icon are within paranthesis wich means that the
  163. ToolType is ignored. To make the i.e. PUBLICSCREEN active you will have
  164. to erase the paranthesis and save the current settings.
  165.  
  166.  
  167.  
  168. ##
  169. ## Suggestions To Changes And Additions
  170. ##
  171.  
  172. We might add an alarm-feature in a future release.
  173.  
  174.  
  175.  
  176. ##
  177. ## Info About Effects Involving PMClock
  178. ##
  179.  
  180. As far as I know the only limit to how many clocks you can have open at
  181. once is the amount of memory you have. You may notice a fun effect if
  182. you have a slow computer and many PMClock's active on the same screen.
  183. Each PMClock will use some CPU-Power and the screen-update will also take
  184. some time wich means that you can see several PMClock's with different
  185. times.
  186.  
  187. Another funny effect can be noticed if you start Commodores original
  188. clock. This clock will be running 2 SECONDS AFTER PMClock (on a A3000-
  189. system). This is not a bug in PMClock, but I can't tell you if the C=-
  190. clock is faulty. Does this mean that PM-Soft is ahead of C= when it
  191. comes to software development?
  192.  
  193.  
  194.  
  195. ##
  196. ## The revision history of PMClock
  197. ##
  198.  
  199. History of changes (exept bugfixing and optimizing):
  200.  
  201. V1.50 Adding SECONDS (ON|OFF) and WIDTH tooltypes
  202.       Error when calculating default LEFT on PUBLICSCREEN fixed
  203.       Major source revision
  204.       Size: 4840
  205.  
  206. V1.41 Removed hilarious Enforcer-HIT
  207.       Size: 4900
  208.  
  209. V1.40 Default left position adapts to sizevariation in the screen's
  210.       depthgadgetwidth
  211.       Size: 5420
  212.  
  213. V1.35 Now Height of the clock adapts to the FontSize of the screen
  214.       it's going to open on
  215.  
  216. V1.30 Now senses Bigger-then-average screens and overscan so default
  217.       position is always in the top left corner of the screen,
  218.       even on publicscreens
  219.       
  220.       Works with the version command
  221.  
  222. V1.20 You can now type in the tooltypes as argument at the CLI prompt
  223.       if you want: ex. PMClock TOP=50 LEFT=200
  224.  
  225. V1.10 Now reads the tooltypes from it's icon
  226.  
  227.       Known tooltypes: TOP          
  228.                        LEFT         
  229.                        DELAY        (in ticks)
  230.                        PUBLICSCREEN (eg. PUBLICSCREEN=TERM)
  231.  
  232. V1.00 Initial release, just opened the clock at y=0, x=486
  233.       Auto detaching from Shell
  234.  
  235.  
  236.  
  237. ##
  238. ## Distribution
  239. ##
  240.  
  241. The latest version of PMClock will be FTP'd to an AmiNet site and hopefully
  242. mirrored around the world. 
  243.  
  244. You may (should) distribute PMClock if you include the following 6 files:
  245.  
  246.         PMClock
  247.         PMClock.info
  248.         PMClock.doc
  249.         PMClock.doc.info
  250.         PMClock.guide
  251.         PMClock.guide.info
  252.  
  253.  
  254.  
  255. ##
  256. ## Contact Us
  257. ##
  258.  
  259. You can contact us at these adresses:
  260.  
  261. PM-Soft C/O             or      PM-Soft C/O
  262. Niklas Dahlman                  David von Plenker-Tind
  263. Ympningsvägen 14                Priorvägen 14
  264. S-240 14  Veberöd               S-240 10  Dalby
  265. Sweden                          Sweden
  266.  
  267. or via É-Mail over Internet to d92nd@efd.lth.se
  268. (The É-Mail adress is to Niklas)
  269.  
  270.